camelcase-keys

What is camelcase-keys?

The camelcase-keys npm package is designed to convert object keys to camel case. It can be used to transform keys in objects, arrays of objects, and deeply nested objects. This is particularly useful when dealing with APIs that return data in snake_case or other formats and you want to convert the keys to camelCase to maintain JavaScript naming conventions.

What are camelcase-keys's main functionalities?

Convert object keys to camel case

Converts the keys of a single object to camel case. For example, {'foo_bar': true} would become {'fooBar': true}.

{"foo_bar": true}

Convert array of objects

Converts the keys of every object in an array to camel case. For example, [{'foo_bar': true}, {'bar_baz': false}] would become [{'fooBar': true}, {'barBaz': false}].

[{"foo_bar": true}, {"bar_baz": false}]

Deep key conversion

Converts keys to camel case recursively for deeply nested objects. For example, {'foo_bar': {'inner_key': 'value', 'another_key': {'deep_key': 'deep_value'}}} would become {'fooBar': {'innerKey': 'value', 'anotherKey': {'deepKey': 'deepValue'}}}.

{"foo_bar": {"inner_key": "value", "another_key": {"deep_key": "deep_value"}}}

Exclude keys from being camelCased

Allows certain keys to be excluded from being converted to camel case. For example, {'foo_bar': true, 'do_not_change': false} with 'do_not_change' as an excluded key would result in {'fooBar': true, 'do_not_change': false}.

{"foo_bar": true, "do_not_change": false}

Other packages similar to camelcase-keys

humps

The humps package is similar to camelcase-keys and provides functions for converting between camelCase and snake_case. It also offers the ability to decamelize keys, which camelcase-keys does not.

snakecase-keys

As the name suggests, snakecase-keys is designed to convert object keys to snake_case. It is the opposite of camelcase-keys, which converts keys to camelCase.

change-case-object

This package offers a variety of case transformations for object keys, including camelCase, snake_case, and others. It provides more general case conversion functionality compared to camelcase-keys, which focuses specifically on camelCasing.

README

camelcase-keys

Convert object keys to camelCase using camelcase

Install

$ npm install --save camelcase-keys

Usage

const camelcaseKeys = require('camelcase-keys');

// Convert an object
camelcaseKeys({'foo-bar': true});
//=> {fooBar: true}

// Convert an array of objects
camelcaseKeys([{'foo-bar': true}, {'bar-foo': false}]);
//=> [{fooBar: true}, {barFoo: false}]

camelcaseKeys({'foo-bar': true, nested: {unicorn_rainbow: true}}, {deep: true});
//=> {fooBar: true, nested: {unicornRainbow: true}}

const camelcaseKeys = require('camelcase-keys');

const argv = require('minimist')(process.argv.slice(2));
//=> {_: [], 'foo-bar': true}

camelcaseKeys(argv);
//=> {_: [], fooBar: true}

API

camelcaseKeys(input, [options])

input

Type: Object Object[]

Object or array of objects to camelCase.

options

Type: Object

exclude

Type: string[] RegExp[]
Default: []

Exclude keys from being camelCased.

deep

Type: boolean
Default: false

Recurse nested objects and objects in arrays.

License

MIT © Sindre Sorhus